home *** CD-ROM | disk | FTP | other *** search
/ ETO Development Tools 1 / ETO Development Tools 1.iso / Essentials / MacApp Documentation / MacApp AppleLink Messages / MacApp.Tech$ 4⁄13⁄90 / 1056-Abb.'s Plc. In McAp.-Apr90 < prev    next >
Encoding:
Text File  |  1990-04-16  |  2.0 KB  |  57 lines  |  [TEXT/GEOL]
  1. Item forwarded  by  A33          to A34
  2.  
  3. Item    3192219                         8-April-90        23:23PDT
  4.  
  5. From:   MADA2                           MacApp Dev Assoc, Curtis Faith,IVC
  6.  
  7. To:     MACAPP.TECH$                    MacApp Technical
  8.  
  9. Sub:    Abb.'s Plc. In McAp. (huh?)
  10.  
  11. I have a request for MacApp 2.1 or whatever post 2.0 will be called.
  12.  
  13. I would like someone to take a good hard look at the names in MacApp and fix
  14. them.
  15.  
  16. I particular I am referring to abbreviations.  Why not use the whole word?  We
  17. can always abbreviate in our own code and then globally replace if we don't
  18. like to type.  I end up having to type things twice after the compiler flags
  19. wrong abbreviations.
  20.  
  21. TList uses InsertBefore, InsertLast etc, but then balks at number in
  22. GetEqualItemNo.  Why not GetEqualItemNumber?  I have to think: Is that Num,
  23. Number or No?   I would prefer to type another few letters!
  24.  
  25. TGridView uses InsRowBefore instead of InsertRowBefore as one might expect
  26. based on looking at TList.  If we are going to abbreviate insert let's do it
  27. all the time or not at all.
  28.  
  29. I have also seen numerous instances of abbreviations of 4 letter words to 3,
  30. text to txt, item to itm etc.  One letter is not worth the trouble!
  31.  
  32. We have enough problems already trying to figure out the Toolbox.  Quickdraw
  33. uses DisposPixMap and at the same time DisposeRgn.  This is Madness!  It
  34. catches me every single time!
  35.  
  36. I would rather have everything be fixed once and have it break every
  37. application I ever wrote so I could be done with this.  It would be pretty easy
  38. to write a script to globally replace the new words anyway.
  39.  
  40. Here are my suggestions:
  41.  
  42. 1) Don't use abbreviations unless you can save 4 or 5 characters.  App for
  43. application and coord for coordinate is ok by me.  itm for item or even eql for
  44. equal is not.
  45.  
  46. 2) If you break rule 1 break it everytime for a given word.
  47.  
  48. 3) Only break rule 2 if you want me to write another link.
  49.  
  50. This is really trivial stuff, but then I am sometimes bugged by trivial things
  51. at 11:15 on Sunday nights.
  52.  
  53. Cheers!
  54.  
  55. - Curtis
  56.  
  57.